Skip to main content

temprole scheduled_role - Scheduled Role Command

Command Title

/temprole scheduled_role

Description

This command allows you to create or modify a scheduled role that will be automatically deleted from the server on a specified date.

Usage

/temprole scheduled_role <role> <end_time>

Parameters

  • <role>: Select the role to be scheduled from the role list.
  • <end_time>: Set the end time for the scheduled role in YYYY-MM-DD HH:MM format. Maximum duration is 30 days. Premium users have unlimited duration.

Examples

  • Example 1: Schedule the @VIP role to expire on January 1, 2024, at 12:00 PM.

    /temprole scheduled_role role:@VIP end_time:2024-01-01 12:00
  • Example 2: Modify the end time of an existing scheduled role @VIP to February 15, 2024, at 6:00 PM.

    /temprole scheduled_role role:@VIP end_time:2024-02-15 18:00

Notes

  • Scheduled roles will be automatically removed upon their expiry. Please ensure Engagerly has the 'Manage Roles' permission and that its role is positioned higher in the role hierarchy than the scheduled role. If these conditions are not met, the automatic removal may fail.
  • The end time must be in YYYY-MM-DD HH:MM format.
  • The maximum duration for a scheduled role is 30 days for free users.
  • Premium users have no time limit for scheduled roles.
  • If a scheduled role already exists for the specified role, this command will modify its end time.

FAQ

  • Q: Can I schedule multiple roles for the same user?

    A: Yes, you can schedule multiple roles for the same user, each with its own end time.

  • Q: What happens if I set an end time in the past?

    A: The command will not execute, and you will receive an error message.

  • Q: Can I cancel a scheduled role before it expires?

    A: Yes, you can use the command /temprole permanent to cancel the scheduled role.